{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Custom filters and other infrastructure types\n",
    "\n",
    "Author: [Geoff Boeing](https://geoffboeing.com/)\n",
    "\n",
    "Use OSMnx to download and visualize a power line network and a subway system.\n",
    "\n",
    "  - [Overview of OSMnx](http://geoffboeing.com/2016/11/osmnx-python-street-networks/)\n",
    "  - [GitHub repo](https://github.com/gboeing/osmnx)\n",
    "  - [Examples, demos, tutorials](https://github.com/gboeing/osmnx-examples)\n",
    "  - [Documentation](https://osmnx.readthedocs.io/en/stable/)\n",
    "  - [Journal article/citation](http://geoffboeing.com/publications/osmnx-complex-street-networks/)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'0.16.0'"
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import osmnx as ox\n",
    "%matplotlib inline\n",
    "ox.config(use_cache=True, log_console=True)\n",
    "ox.__version__"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Use custom filters to fine-tune your network. OSMnx uses `network_type` presets to query for streets that allow walking, biking, driving, etc. You can override this by passing a `custom_filter` to specify specific OSM ways you want in your graph."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "34 motorway\n",
      "11 primary\n",
      "45 motorway + primary\n"
     ]
    }
   ],
   "source": [
    "place = 'Berkeley, California, USA'\n",
    "\n",
    "# only get motorway ways\n",
    "cf = '[\"highway\"~\"motorway\"]'\n",
    "G = ox.graph_from_place(place, network_type='drive', custom_filter=cf)\n",
    "print(len(G), 'motorway')\n",
    "\n",
    "# only get primary ways\n",
    "cf = '[\"highway\"~\"primary\"]'\n",
    "G = ox.graph_from_place(place, network_type='drive', custom_filter=cf)\n",
    "print(len(G), 'primary')\n",
    "\n",
    "# use the pipe (|) as 'or' operator\n",
    "cf = '[\"highway\"~\"motorway|primary\"]'\n",
    "G = ox.graph_from_place(place, network_type='drive', custom_filter=cf)\n",
    "print(len(G), 'motorway + primary')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [],
   "source": [
    "# network of the canals of amsterdam\n",
    "place = 'Amsterdam, Netherlands'\n",
    "G = ox.graph_from_place(place, custom_filter='[\"waterway\"~\"canal\"]')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To download the road network for an entire country, you often need to limit your query to something like motorways only, to fit in your computer's RAM. For large queries, such as the entire nation of Belgium, OSMnx will subdivide your query into multiple server requests to download all the data, then assemble the graph."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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448//jBIb8aYevbsWWa/9KhUKvr378/58+dLnSwB9uzZQ1BQENOmTWPDhg1cunTphe7j6OiIXC7n5s2b+sd+/fVX/f/Pz8/H39+fO3fulDrm8ig3N5fNmzezefNmfRWvFi1a0L59e7Kzs7l9+zZ//vlnuZu+EcoPs9eS7dixI23atGHlypXcunXL2M0ZnZ+fH6+//jo//fSTwcuBBQQEMHToUBQKBZs3bzbbwdTP07x5c3r06MHKlSsf+fAvC2QyGe+//z4An3/+uUHv3adPHxo1akRERAQrV64sca+nSZMmdO3alZkzZz7x+TFjxmBra8u3335riHArjMqVKzNy5EikUilKpZLY2FiOHTvGpUuXRPIUXkiZLL6uUqmYMWNGsQ9kLg+mT59OdHQ0K1euNFobvXr1okmTJiQmJrJ8+fIytdG7c+fONG3alP3795e5+UuVSsU777yDXC7nyy+/JC8vz+BteHp6MmbMGJRKJevWrSvRIpVBgwbh5eX11GO8atasyZAhQ5g2bZpIBE8RHBxM69at8fLyQiaTkZWVpT9o4eLFi2LoViiWMpkwhw4dip+fH3PnzjVmMyYzdOhQqlevzpw5c4z+D9PR0VG/aOXgwYNmr9Vau3Ztunfvjq2tLX///Tdnz5594utkMplZ5uG6du1Kw4YNUavVfP3110avstSvXz/q169PeHg4q1evLtZ7nj17NrGxsfz8889PfF4ikTB37lzWrVvHlStXDB1yhVOpUiXq169PQEAALi4uKBQKcnNziYiI4OTJkxViREswjjKXMIuG7VavXv1I3czyqlmzZvTo0YOlS5cSERFhsnabN29O165dyc7OZtWqVSYtftCkSRNatmyJjY0NCoWC8PBw/vrrryfuI2zYsCFt2rTBycmJ5ORkdu7cabK/dycnJ959910AZsyYYbKE7evry6hRo5BKpfzyyy/P/Ltp2bIlnTt35qeffnrm6uopU6YgkUjEsOwLsLOzo2HDhjRs2FB/KMPWrVvNHZZQBpWZhCmRSPjggw+wsbFh9+7dHD161NBNmEzRnEnlypUZPHgwp0+ffmSDu6moVCpGjhyJn58fly9f5s8//zR6+bTu3bvTokUL1Go1+/bt48SJE8/sVVerVo06derg5+dHdnY23t7eaDQafv75Z6MWx69duzYDBw4kOTmZI0eO6OuZmopEImH0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LFmyxCQrWpctW4a3tzdjxoxhxowZrFu3jhs3bhi9XVMzxKKf/5WZmVmmv2A0adKEtm3bolQqSUxM5MaNG0RERBATE2PUD3WZTMa7776rPxJNpVIhl8tJSUnhu+++K/HB5//88w8+Pj68++67LF261GRTCIWFhY8s9HnzzTfx9fXl77//fmSVtJ+fH23atKFr16706NGD5ORkbty4wfXr14mKihLbU0pJJEwDKzoTszxq1aoVoaGhVKpUibt377JixQqTH0IcExPD3LlzGTBgACNHjiQiIoJVq1ZVqAVBxkiYNjY2ZbKIgZubG+PGjcPKyor8/HykUikWFha0atWKTp06IZFI0Gq1FBYWUlBQgFqtJjs7m5SUFLRaLXfv3tWvFoWHCdDV1ZWMjIynFvIv4uHhwRtvvIFEItGXIixKIHl5eS/8nn744QdGjBjBm2++yebNm42+rUcikWBtbf3IHKWPjw9//fUXFy9efOS1ERERREREAA+3xjRr1oz69evTsmVL/c8hPT2dS5cucejQoXL/5d7URMI0MGdn53J5HFDlypXp0qULarWar776yqznAGq1WtatW8eRI0cYOXIk06dPZ+vWrZw6dcpsMRlSUZIwFBsbGywsLB5JLGVBx44dadu2LVFRUSxYsOCJH84WFhZ4enri4uKCvb09NjY2ODg44O3tjYODg36esbCwEIlEgkwmQ6fTIZFIKCgo4MKFC2zevPmx+1aqVIlJkyZx7949li1bZvDe9+rVq2nXrh19+vTB1dWV7du3G/T+/23ChAnk5+eTnJysf2zz5s3PnUe9devWI6+xsbEhMDCQmjVr0qJFC9q3b09+fj45OTlYWFhQUFDA6dOniY2NJTExkYyMjDI9amEOImEamJeXV7k72aB27doMHjyYvLw8/vjjjzJzaG5sbCzz58+nW7du9O7dm6ZNm7JixYqnHotVXuTn5xMUFMTOnTsNcr9mzZqRl5dXJraV2NnZ0a1bN6pWrYpUKmXXrl0cPnz4qa/Py8vj7t27Tzz42t7enoyMDJydnfHw8KCwsJDo6GiysrKwtrZmypQpNGrUiMTERE6cOKG/rnr16gwfPpw7d+6wfPlyo7xPgP3795OUlMSQIUN48OABR48eNXgbgwcPxsXFhZ9++umRx8+cOVPie2VlZXHhwgX9wiFXV1eqVauGu7s7devWRSqV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\n",
      "text/plain": [
       "<Figure size 576x576 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "CPU times: user 50.3 s, sys: 564 ms, total: 50.9 s\n",
      "Wall time: 50.6 s\n"
     ]
    }
   ],
   "source": [
    "%%time\n",
    "# get only motorways, trunks, and their links in all of Belgium\n",
    "# takes a couple minutes to do all the downloading and processing\n",
    "# OSMnx automatically divides up the query into multiple requests to not overload server\n",
    "cf = '[\"highway\"~\"motorway|motorway_link|trunk|trunk_link\"]'\n",
    "G = ox.graph_from_place('Belgium', network_type='drive', custom_filter=cf)\n",
    "fig, ax = ox.plot_graph(G, node_size=0)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 576x576 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# get NY subway rail network\n",
    "# note this is rail *infrastructure* and thus includes crossovers, sidings, spurs, yards, etc\n",
    "# for station-based rail network, you should download a station adjacency matrix elsewhere\n",
    "ox.settings.useful_tags_way += ['railway']\n",
    "G = ox.graph_from_place('New York City, New York', retain_all=False, truncate_by_edge=True,\n",
    "                        simplify=True, custom_filter='[\"railway\"~\"subway\"]')\n",
    "\n",
    "fig, ax = ox.plot_graph(G, node_size=0, edge_color='w', edge_linewidth=0.2)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python (ox)",
   "language": "python",
   "name": "ox"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.8.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}
